home *** CD-ROM | disk | FTP | other *** search
/ Acorn User 10 / AU_CD10.iso / Updates / AMP / !Amp / Docs / Help (Text) < prev    next >
Text File  |  2000-05-14  |  15KB  |  348 lines

  1.  
  2. Amp v2.00 (14th May 2000)
  3. Written by David O'Shea.
  4.  
  5.   --------------------------------------------------------------------------
  6.  
  7. Contents:
  8.     * Introduction
  9.     * Requirements
  10.     * Skins
  11.     * Plug-ins
  12.     * Playlists
  13.     * Notes
  14.     * History
  15.     * Thanks to
  16.     * Contact
  17.     
  18.   --------------------------------------------------------------------------
  19.  
  20. Not another "desktop tracker" program!?
  21.  
  22.  Yes... !Amp is another music player. BUT, it's based on the PC program WinAmp. This means that you can use the hundreds of PC skins available to totally change the look. It has a compact layout, and can fold up into it's titlebar for when you're really short of desktop space!
  23.  
  24. It's also really easy to park the window where you want it to be - it clings to the edges of the screen and the icon bar.
  25.  
  26.   --------------------------------------------------------------------------
  27.  
  28. Requirements
  29.  
  30.  You need Window Manager 3.80 or later (nested window manager).
  31.  
  32.  To use the MP3 player plugin, you need a StrongARM.
  33.  
  34.   --------------------------------------------------------------------------
  35.  
  36. Skins
  37.  
  38. In theory, you should be able to use any of the thousands of PC skins available, but in practice, not all work 100%. In most cases, this simply because ChangeFSI can't understand the BMP. The solution in this case is simply to find a program which does (you might have to resort to a PC) and reconvert the file to a proper BMP (or in fact any other format understood by ChangeFSI).
  39.  
  40. It is possible though that this is not the only reason, and if you feel that this is the case (eg you can load the offending BMP in ChangeFSI manually), then email me and let me know about it. I might ask you to send the skin so that I can investigate.
  41.  
  42. Anyhow, to install a skin, simply click 'Skin...' from the Amp menu, and then close the skin browser window with Adjust, or hold down SHIFT and double-click !Amp to open the application directory, then double-click on the 'Skins' directory. Now make a directory for the skin. This is the name the skin will have in the browser window. Put all the relevant BMPs and textfiles from the skin inside the new directory. (You can remove any DLL files, since these are x86 code.)
  43.  
  44. WARNING: Don't delete anything from the Original directory, since if a skin is broken or has bits missing, Amp will resort to this to replace bits.
  45.  
  46. Even if Amp is already running, the skin will be picked up next time you open the skin browser. Choose it and it will be converted to a spritefile called Skin inside in the same directory. Depending on your machine, either 256 or 16 million colours will be used. You can force one or the other by editing the application's !Run file. If you want to save space, you can delete the original BMPs, but I'd advise you to keep them just in case you want to swap between 256/16M colours later. They are also needed if you ever flush the browser preview file.
  47.  
  48. You can even use !Squash to compress the sprite file if you like! It'll be automatically unsquashed into RAM when you use it. If you have the 'Squash' app in your path (e.g. in Boot:Library, or you have run !Squash) then the skins will be automatically squashed just after being converted by ChangeFSI.
  49.  
  50.   --------------------------------------------------------------------------
  51.  
  52. Plug-ins
  53.  
  54.  Amp works by using plug-ins to play everything. This means that it's easy to add another plug-in to play a new type of tracker, and if you can program yourself, you can easily write one without hacking about with the main program.
  55.  
  56. The current plug-ins are as follows (in various stages of completion):
  57.  
  58.     * Midi
  59.         * BASIC prog based on Linux playmidi sources
  60.         * Only plays one track before it breaks
  61.         * Not the best if you're actually using the computer!
  62.     * matrixTracker
  63.         * Uses matrixTRK (Michael Pohle & Marko Lukat)
  64.         * Kinda always repeats
  65.     * Audio CD
  66.         * Supports track naming via CDDB
  67.         * Supports balance adjustment (assuming your drive does...)
  68.     * Digital Symphony
  69.         * Uses DSymPlay (BASS)
  70.         * Supports repeat
  71.     * Audio MPEG
  72.         * Uses AMPlayer (Thomas Olsson)
  73.         * Reads ID3 tags for the song name
  74.         
  75.     * STracker, STModule, TeqMusic
  76.         * Uses QTMModule (Phoenix/QUANTUM)
  77.     * Sound Sample Plugin
  78.         * Uses PlayIt (Rick Hudson)
  79.         * Plays WAV, Armadeus, AudioWorks and more
  80.         * Supports balance
  81.     * XprMod Plugin
  82.         * Uses XprMod (Skoe of Expression)
  83.         * Plays S3M, FastTracker
  84.         * Doesn't stop properly
  85.         * Position bar sometimes wobbles a bit
  86.     * TimPlayer Plugin
  87.         * Uses TimPlayer (André Timmermans)
  88.         * Plays ImpulseTracker
  89.         * Always loops
  90.         * No channel info
  91.  
  92.  
  93.   --------------------------------------------------------------------------
  94.  
  95. Playlists
  96.  
  97.  Amp also supports playlists. These are basically text files which contain your favourite lists of tunes in whatever order you choose. You can easily edit the text file. Don't mess it up though - the program doesn't really like mangled lists!
  98.  
  99. You can currently drag a music file to the playlist window to add it, and double-click on an entry in the window to play it.
  100.  
  101. Drag a previously saved playlist to any Amp window (or the iconbar) and it'll try to load it as a playlist. If you save your playlist as !Amp.PlayList or Choices:Amp.PlayList then it will automatically be loaded every time.
  102.  
  103.  
  104.   --------------------------------------------------------------------------
  105.  
  106. Notes:
  107.  
  108.  You can quit the program without stopping the music. This means that Amp is still using memory after you quit it. If you are using dynamic areas, this is fine, since the area will be reused when you next load Amp and if you quit stopping the music, it will be removed then. However, if you are stuck with using the module area, it will leave a chunk (possibly quite large, depending on the song/plugin playing it) which you can never reclaim without resetting the machine. You have been warned!
  109.  
  110.  
  111.   --------------------------------------------------------------------------
  112.  
  113. History:
  114.  
  115. v2.00
  116. 14th May 2000
  117.  
  118. Totally re-written in C.
  119. Now shows song time in the playlist window.
  120. You can choose between time elapsed and time remaining.
  121. It is now possible to reorder tracks in the playlist.
  122. Windock between windows now works.
  123. The dock distance is now adjustable.
  124. The skin browser is improved.
  125. Plugin change improved.
  126. The control buttons in the playlist window work.
  127. Scrollbar on playlist is better (doesn't get lost anymore).
  128. Less memory usage/faster startup.
  129. Fixed CTRL+0 which appeared in the options file.
  130. No more spaces in saved playlist files.
  131. Added "seek to" display.
  132. Now uses MessageTrans for all text strings.
  133. Finally stores playlist position/size and whether it was open or not.
  134. You can now batch convert skins.
  135. Added a command line tool for converting skins.
  136. Now has plugin configuration protocol (currently only cd plugin uses it).
  137. Masks out non-used wimp messages (should use less polls).
  138. Uses separate balance sprites if available (flush any skins which have balance/nums_ex/font bmp files).
  139.  
  140.   --------------------------------------------------------------------------
  141.  
  142. v1.13
  143. 26th September 1999
  144.  
  145. Now works on new RO4 format discs.
  146. Uses Rick Hudson's PlayIt module for sample playing instead of ESP's SamplePlayer.
  147.  
  148.   --------------------------------------------------------------------------
  149.  
  150. v1.12
  151. 15th August 1999
  152.  
  153. Now you can add your own entries to the CDDB database.
  154. Fixed address exception with shuffle mode on an empty playlist.
  155. Shuffle no longer always plays the first song first.
  156. No longer chops the end of small mpegs. May also fix an address exception which sometimes occured with a playlist of mpegs.
  157.  
  158.   --------------------------------------------------------------------------
  159.  
  160. v1.11
  161. 15th June 1999
  162.  
  163. Play with no active song now starts playlist.
  164. Shuffle should now not repeat songs until they're all played.
  165. Back now plays previous song played, even in shuffle mode.
  166. Fixed shuffle related redraw bugs in playlist window.
  167.  
  168.   --------------------------------------------------------------------------
  169.  
  170. v1.10
  171. 16th May 1999
  172.  
  173. Amp now uses lots less CPU time (with !TaskUsage anyway).
  174. Fixed an ADRL I missed last time.
  175. Fixed the address exception when selecting all with an empty playlist.
  176. Playlist window bugfixes for sonicated2 skin.
  177. Mouse click offset in playlist window fixed.
  178. No longer crashes with skins which are too big.
  179. Removed position bar trail from skins like "Fusion".
  180. Balance slider now 'sticks' to the centre.
  181.  
  182.   --------------------------------------------------------------------------
  183.  
  184. v1.09
  185. 19th April 1999
  186.  
  187. Fixed some always-on-top bugs.
  188. Removed dependency on Darren Salt's BASIC assembler extender.
  189. Amp now loads when you've no CDROM drives configured.
  190. Hopefully fixed the get-rectangle bug when you try to stop an MP3.
  191. Newer version of DSymPlay added.
  192.  
  193.   --------------------------------------------------------------------------
  194.  
  195. v1.08
  196. 5th April 1999
  197.  
  198. Fixed numbering of playlist entries > 255.
  199. Scrollbar in playlist shouldn't vanish anymore.
  200. Last song in playlist is no longer half obscured.
  201. Better window dragging.
  202. Added Oscilliscope code for 256 colour modes.
  203. Much reduced (halved) wimpslot at slight expense of loading time.
  204. MP3 plugin now accepts underscore as an extension specifier (for CDs).
  205. Playlist entries resized to fit letters with descenders properly.
  206. You can now drag on a directory to queue all the files therein (recursively!).
  207. Added AMPlayer MP3 plugin.
  208. Much reduced idle CPU usage.
  209. The 'Select All' button in the playlist window now works.
  210.  
  211.   --------------------------------------------------------------------------
  212.  
  213. v1.07
  214. 14th March 1999
  215.  
  216. Finally figured out why the playlist kept stopping. Should be fixed now.
  217. Fixed the "untickable" vis menu option.
  218. Added some error checking to prevent the dmpa plugin from crashing.
  219. Playlist can now have more than 76 entries (oops!)
  220. Added the options window to the clutterbar.
  221.  
  222.   --------------------------------------------------------------------------
  223.  
  224. v1.06
  225. 28th February 1999
  226.  
  227. More human friendly config file format.
  228. Lots more ARM code. Though this currently means the program takes longer to load, it will eventually result in a smaller Wimp slot.
  229. Fixed minibar sprite (was missing one pixel row) - flush your skins.
  230. Fixed skins which replace the playlist.
  231. Finally, a config window added.
  232. Font in playlist window now reads colours and font from skin file.
  233. Playlist entries now have numbers.
  234. No more exceptions when you try to delete entries from an empty playlist.
  235. Added some hotkeys for the playlist window (^X, cursor up and down).
  236. Hopefully more reliable playlist (shouldn't fail to play next song anymore).
  237. Fixed "Input focus window not found" error.
  238. Updated TimPlayer module.
  239.  
  240.   --------------------------------------------------------------------------
  241.  
  242. v1.05
  243. 5th February 1999
  244.  
  245. Fixed a 'Handle is either illegal or has been closed' error message.
  246. Fixed problems reloading after a skin flush when original skin not selected.
  247. Freezing bug when mini-window selected after doublesize toggle fixed.
  248. Memory problem with 256 colour sprites fixed.
  249. You can now delete files from the playlist! (No hotkeys yet though)
  250. Playlist font changed to be more WinAmp like.
  251.  
  252.   --------------------------------------------------------------------------
  253.  
  254. v1.04
  255. 31st January 1999
  256.  
  257. Fixed song name disappearing bug.
  258. Added support for both S3M filetypes.
  259. Oops, really fixed so that truncated skin filenames work on long filename filesystems.
  260. Changed method of unpausing CD so it works with more setups.
  261. Added resizing playlist window with scrollbar (still a bit dodgy).
  262. Added TimPlayer for ImpulseTracker mods.
  263.  
  264.   --------------------------------------------------------------------------
  265.  
  266. v1.03
  267. 11th January 1999
  268.  
  269. A bit of an overhaul - now lots more ARM code, including the player plugin subsystem.
  270. Fixed dmpa's wimpslot.
  271. Fixed menu clicks in the skin browser window.
  272. Added XprMod plugin.
  273. MP3s now die properly if you start a new one, even when just about to stop itself.
  274. Fixed RMA code for skin preview window.
  275. Skins can now be deleted from the preview window.
  276. Fixed so that truncated skin filenames work on long filename filesystems.
  277. Improved CD plugin.
  278. Reduce idle CPU usage.
  279. Improved the playlist window look.
  280. Added shuffle (sort of).
  281.  
  282.   --------------------------------------------------------------------------
  283.  
  284. v1.02
  285. 17th November 1998
  286.  
  287. New nice skin selection window.
  288. Added the new (Winamp 2) basic skin.
  289. You can now load and save playlists properly.
  290. Allowed for skins in zip files (with SparkFS, etc) again (oops!).
  291. Fixed the starting of a new MP3 before the old one is finished.
  292. You can now quit without stopping the music.
  293. Now reuses left over plugin buffer dynamic areas present when you reload the program.
  294. Rearranged the internal directory structure a bit.
  295. Fixed a bug whereby you could create multiple iconbar icons.
  296. CD plugin now works on more drives and is quicker changing tracks.
  297. Back and forward buttons now skip tracks on a CD.
  298. Added balance (only affects CD plugin).
  299. Removed claim of filetype AE7 (ARMovie) as this was causing problems with ARPlayer.
  300. Fixed 'Player Module' error from FB1 (WAV plugin).
  301. Other small tweaks.
  302.  
  303.   --------------------------------------------------------------------------
  304.  
  305. v1.01
  306. 26th October 1998
  307.  
  308. Fixed a problem calling ChangeFSI.
  309. Fixed "missing digits" problem.
  310. Overhauled redraw code which fixes various flickering problems, and allows a double size window.
  311. Clutterbar now works.
  312. Fixed a small bug in skin conversion. This means old skins won't display properly, sorry!
  313. CD no longer lists data tracks.
  314. Added support for squashed skins.
  315. Added limited ID3 tag support.
  316. Improved this help file.
  317. Added a sample player plugin (for 16 bit sound).
  318. Various other improvements.
  319.  
  320.   --------------------------------------------------------------------------
  321.  
  322. v1.00
  323. 11th October 1998
  324.  
  325. Playlist not fully working.
  326. Plug-ins at various stages of development.
  327. Shuffle not working.
  328. Not much in the way of documentation.
  329.  
  330.   --------------------------------------------------------------------------
  331.  
  332. Thanks to:
  333.     * Robert O'Sullivan, for his help, ideas (including the idea to write it in the first place!) and testing.
  334.     * Bernhard Ludewig for permission to use his sprites.
  335.     * James Reynolds for writing !Spectrum.
  336.     * Mike Gregory, Francis Chin, Robert Purchase, Laurent Domisse and all the other beta testers for their testing, encouragement and feedback.
  337.     * Darren Salt for writing ExtBasAsm.
  338.  
  339.   --------------------------------------------------------------------------
  340.  
  341. Contact:
  342.     * Email:
  343.     
  344.         koshea@indigo.ie (Home)
  345.         doshea01@cork.cig.mot.com (Work)
  346.         
  347.     * Web Site: http://homepage.eircom.net/~djkoshea
  348.